home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / WCSROK12.ZIP / WCSROOK.DOC < prev    next >
Encoding:
Text File  |  1996-01-10  |  20.0 KB  |  492 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.      _____________________________________________________________________
  19.  
  20.  
  21.  
  22.  
  23.                                WCS Rook 'em v1.2
  24.                                         
  25.                                   Written by
  26.  
  27.                                  Rob Williams
  28.                                  WCS Software
  29.  
  30.  
  31.      _____________________________________________________________________
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                             Copyright Notice
  52.                             ----------------
  53.  
  54.      This door game is distributed under the SHAREWARE concept.  This
  55.      concept gives you the chance to "try before you buy", and see if it
  56.      meets your needs.
  57.  
  58.      I've decided to break away from the standard "30 day trial period"
  59.      that many door authors are using and instead go to a much simpler
  60.      and more realistic policy. This is simply; Try it on your BBS.
  61.      If you like it and your users like it, then register it.  If it's not
  62.      good enough to register, then delete it.
  63.  
  64.      While I'd like you to register my doors as soon as possible, I'm also
  65.      realistic enough to know that different boards have different requirements
  66.      and interests, and sometimes it takes longer befor a game catches on, or a
  67.      sysop can get to the Doors on his list to register.  And frankly, I'd
  68.      rather you ran it for awhile and register, than try it for a short
  69.      period of time and delete it. Nobody wins that way...I lose out on a
  70.      registration and your users lose out on the chance of having the
  71.      registered door to play.
  72.  
  73.      The above "extended trial" statement was copied with permission from
  74.      Mike Jordan of M&S Doors.
  75.  
  76.      As a shareware  program, WCS Rook 'em may be freely distributed.
  77.      Shareware distributors may distribute copies of WCS Rook 'em on disk
  78.      for a modest disk duplication charge not to exceed $4 per disk.
  79.  
  80.  
  81.  
  82.                                     Warranty
  83.                                     --------
  84.  
  85.      WCS Rook 'em is distributed on as as is basis.  In no event will
  86.      Rob Williams or WCS Software be liable to you for damages, including
  87.      any loss of profits, lost savings, or other incidental or
  88.      consequential damages arising out of your use of or inability to use
  89.      this program, even if Rob Williams, WCS Software, or an authorized
  90.      representative has been advised of the possibility of such damages.
  91.      Rob Williams and WCS Software will not be liable for any such claim
  92.      by any other party.
  93.  
  94.  
  95.                         Features of WCS Rook 'em
  96.                         ------------------------
  97.  
  98.      WCS Rook 'em is fully InterBBS capable, with very little attention
  99.      needed from the sysop.  Automatic messaging to/from the game hub
  100.      in Fido standard *.MSG format messages with file attachments.
  101.  
  102.      Assembly language serial input/output routines for maximum speed.
  103.  
  104.      Fully supports high speed modems: 16550 FIFO buffering and locked
  105.      serial ports.
  106.  
  107.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded in
  108.      memory.
  109.  
  110.      DesqView, Windows, and OS/2 aware.
  111.  
  112.      Supports all of the most popular door data file formats:
  113.      TriBBS, PCBoard, GAP  (DOOR.SYS), Spitfire, WildCat!,  RBBS, and WWIV.
  114.  
  115.      ANSI and ASCII Bulletins of high scorers.
  116.  
  117.      Automatic maintenance with no intervention from the Sysop.
  118.  
  119.      Supports play ahead and make up days when registered.  This is
  120.      completely sysop configurable.
  121.  
  122.      WCS Rook 'em is Multinode Aware!
  123.  
  124.  
  125.                          Files used in the Program
  126.                          -------------------------
  127.  
  128.      WCSROOK.EXE   -   The main WCS Rook 'em program
  129.  
  130.      REGISTER.FRM  -   Information on registration
  131.  
  132.      SAMPLE.CFG    -   Sample configuration file
  133.  
  134.      SAMPLE.BAT    -   Sample batch file to run WCS Rook 'em
  135.  
  136.      HISCORE.DAT   -   Created when the program runs-contains hi score info
  137.  
  138.      ROOKUSER.DAT  -   Created when the program runs-contains user info
  139.  
  140.      WCSROOK.KEY   -   Key file for registered versions
  141.  
  142.      WCSROOK.USE   -   Created when the game is running, will be deleted
  143.                        when the user exits normally.
  144.                        (only in single user/non-registered versions)
  145.  
  146.      *************************************************************************
  147.      ** IMPORTANT - The game will not run if this file (WCSROOK.USE) exists **
  148.      *************************************************************************
  149.  
  150.      WCSROOK.HLP   -   Help file for the game.  When the Instructions option
  151.                        is selected, this file is displayed.  You may edit
  152.                        this file if you wish.  It is a plain ASCII text file.
  153.  
  154.      WCSROOK.HIS   -   History of the product.  Shows what enhancements were
  155.                        made in what version.
  156.  
  157.      WCSINFO.TXT   -   A text file explaining more about WCS Software and
  158.                        showing all currently available WCS Software programs.
  159.  
  160.      READ.ME       -   A brief text file explaining how to get up and running
  161.                        quickly.
  162.  
  163.      NOBEEP        -   If this file exists in the game directory, the game
  164.                        not make noises when you play it (either remotely or
  165.                        locally)  Good for those sysops who play games locally
  166.                        late at night <grin>.
  167.  
  168.      INTERBBS.DOC  -   A document explaining how to set up WCS Rook 'em to
  169.                        run in an InterBBS League.
  170.  
  171.      *****  IT IS VERY IMPORTANT TO READ THIS FILE FULLY BEFORE ATTEMPTING
  172.      *****  TO RUN WCS ROOK 'EM IN AN INTERBBS LEAGUE.
  173.      *****  YOU SHOULD ALSO BE WELL VERSED IN FIDO TERMINOLOGY.
  174.  
  175.      DBRIDGE.HLP   -   Help file for people running D'Bridge mailers.  Also
  176.                        helpful as a fallback if you have problems getting
  177.                        the score files automatically processed. (for InterBBS
  178.                        use)
  179.  
  180.  
  181.                            Setting up WCS Rook 'em
  182.                            -----------------------
  183.  
  184.      WCS Rook 'em is run by  entering a command similar to the
  185.      following:
  186.  
  187.      WCSROOK WCSROOK.CFG
  188.  
  189.      The configuration file can have any name you choose, but it must
  190.      reside in the same directory as the door.  The configuration file is
  191.      an ASCII text file with the following format:
  192.  
  193.      Line 1:   Door data file type.
  194.      Line 2:   Path to the door data file(s).
  195.      Line 3:   BBS name.
  196.      Line 4:   Sysop's name.
  197.      Line 5:   Locked baud rate.
  198.      Line 6:   ASCII High Score Bulletin Name
  199.      Line 7:   ANSI High Score Bulletin Name
  200.      Line 8:   File name to write comments to
  201.      Line 9:   Number of Games per day
  202. *    Line 10:  Number of extra days allowed for make up days
  203. *    Line 11:  Day to start playing make up days-31 to disable
  204.      Line 12:  Write log files (explained below)
  205. *    Line 13:  Line to display a message (donated by, etc)
  206.      Line 14:  Name of the computer opponent
  207.      Line 15:  InterBBS Play (Y or N)
  208.  
  209.      Lines with a "*" to the left indicate features only present in the
  210.      registered version of the program.  *** The lines must be present,
  211.      even if the door is not registered. ***
  212.  
  213.      As illustrated above, the door's data file type is specified in line 1
  214.      and can be PCB for PCBoard, GAP for GAP (DOOR.SYS), SF for Spitfire,
  215.      RBBS for RBBS, WC for WildCat!, TRIBBS for TriBBS, or WWIV for WWIV.
  216.      The locked baud rate is specified in line 5.  If you don't lock your
  217.      serial port, you must specify 0 for the locked baud rate.
  218.      The following is a sample door configuration file:
  219.  
  220.      ************************************************************************
  221.      ** IMPORTANT - If you are running WC 4.x, use the GAP drop file       **
  222.      ************************************************************************
  223.  
  224.      WC                             <== BBS Type
  225.      C:\WC30\WCWORK\NODE1           <== Drop file location
  226.      WCS Software BBS               <== BBS Name
  227.      Rob Williams                   <== Sysop Name
  228.      0                              <== Locked baud rate
  229.      C:\WC30\BULL\BULL10.BBS        <== ASCII bulletin
  230.      C:\WC30\BULL\BULL10.SCR        <== ANSI bulletin
  231.      C:\WC30\COMMENTS.DRS           <== File name to write comments to
  232.      10                             <== # of questions per day
  233.      2                              <== Extra days allowed for make up days
  234.      10                             <== Day to start make up days
  235.      A                              <== Write a log file (See Below)
  236.      By WCS Software                <== Donated by line
  237.      Joe                            <== Computer opponents name
  238.      Y                              <== InterBBS Play
  239.      ************************************************************************
  240.      ** IMPORTANT - Even if the game is not registered, the last  three    **
  241.      ** lines must exist, or the game will not run.  You will get an error **
  242.      ** when the game starts up.                                           **
  243.      ************************************************************************
  244.  
  245.      On line 12, the valid options for a log file are:
  246.         - P for Play log ONLY  (WCSROOK.nodenumber)
  247.         - N for No logs
  248.         - C for Comments log ONLY (Specified in .cfg file)
  249.         - A for ALL Logs (play log and comment log)
  250.  
  251.      WCS Rook 'em can be run locally without a door data file (handy
  252.      for the sysop to use the door without logging on to the BBS) by
  253.      specifying /L after the  configuration  file  parameter in  the  DOS
  254.      command line.  WCS Rook 'em will request you to enter your name before
  255.      running the door.
  256.  
  257.      To play the game in Multiuser mode, you must have a registered multinode
  258.      copy,and DOS SHARE must be loaded.  If these two things are not done,
  259.      the game will display a message if you try to run multinode.
  260.  
  261.      Nonstandard IRQs can be used by specifying the IRQ number after the
  262.      "config" parameter in the command line used to run the door as
  263.      follows:
  264.  
  265.      WCSROOK WCSROOK.CFG 4
  266.  
  267.               Setting up WCS Rook 'em for Multinode Play
  268.               ------------------------------------------
  269.  
  270.     In order to set WCS Rook 'em up for multinode play, you need to create a
  271.     .cfg file for each node that will be using the game.  The .cfg files
  272.     will be similar, except that lines 2 and possibly 5 will be different.
  273.     Line 2 is the location of the door drop file.  This needs to be unique
  274.     for each node that runs the game.  Line 5 is the locked baud rate for
  275.     the node.  If you have nodes that are locked at different rates, then
  276.     this line may be different for different nodes.  For example, the
  277.     configuration file for node 1 (WCSROOK.CF1) might look like this:
  278.  
  279.       GAP
  280.       H:\WILDCAT\WCWORK\NODE1     <=== Notice this is the node 1 directory
  281.       Williams Computer Services BBS
  282.       Rob Williams
  283.       19200
  284.       [etc].....
  285.  
  286.     And the configuration file for node 2 (WCSROOK.CF2) might look like this:
  287.  
  288.       GAP
  289.       H:\WILDCAT\WCWORK\NODE2     <=== Notice this is the node 2 directory
  290.       Williams Computer Services BBS
  291.       Rob Williams
  292.       19200
  293.       [etc].....
  294.  
  295.     You will also need to set an environment variable to tell the program
  296.     what node it is currently running on.  Since I run Wildcat, I call
  297.     this variable WCNODEID.  In my .BAT file that calls the BBS, I set the
  298.     WCNODEID to whatever node is running.  You can use wahtever name you
  299.     wish, it just needs to be a unique node ID.
  300.  
  301.     Next, in the batch file that calls WCS Rook 'em, you would change the sample.bat
  302.     that is included with this archive to look like this:
  303.  
  304.        CD\WCSROOK
  305.        WCSROOK WCSROOK.CF%WCNODEID%
  306.  
  307.     What this will do, is when the game is started, it will look for the
  308.     WCNODEID (or whatever you called it), and append that to WCSROOK.CF.  So
  309.     when the game runs, and you run it from node 1 say, it will use .cfg file
  310.     WCSROOK.CF1.
  311.  
  312.     Hopefully, I have not totally confused you on how to set the door up for
  313.     mult-node use.  If you have questions on environment variables, refer
  314.     to your DOS manual.
  315.  
  316.    **************************************************************************
  317.    ** Running this game on more than a single node at a time requires a    **
  318.    ** Multi-Node Key.  When running in Evaluation mode, only one (1) Node  **
  319.    ** will be able to access the door at a time.                           **
  320.    **************************************************************************
  321.  
  322.  
  323.                             Playing the Game
  324.                             ----------------
  325.  
  326.      WCS Rook 'em is similar to the card game of Rook.
  327.  
  328.  Bidding
  329.  -------
  330.  
  331.      "WCS Rook 'Em" is similar to the card game of "Rook".  All of the cards
  332.      are dealt to you and your computer opponent with 5 cards being saved
  333.      for the "Junk pile".  You start each game by bidding against the computer
  334.      to see who gets the "Junk pile" and the right to name trumps.  The
  335.      computer will start the bid at 90 each time.
  336.  
  337.      You are bidding on how many points you think you can get during the
  338.      game.  Cards are numbered 4 - 14 in 4 different colors.  And there
  339.      is 1 "Ultimate" card, the Rook.  Points are as follows:
  340.  
  341.                 5   -  5 points
  342.                10   - 10 points
  343.                14   - 10 points
  344.                Rook - 20 points
  345.  
  346.      You should use caution in bidding!  If you win the bidding and
  347.      you don't make what you bid, you lose that number of points!
  348.  
  349.      Whoever wins the bidding takes the "Junk pile" and has the option to
  350.      switch some of the cards in their hand with the "Junk pile".
  351.      The winner of the bidding also gets to name the color of trumps.
  352.      Trumps is what you play when you are out of the color being played.
  353.      Trumps will beat anything except the Rook.
  354.  
  355. Game Play
  356. ---------
  357.      Whoever won the bidding plays first.
  358.      1.  If you are starting, you can play anything.
  359.      2.  If you are playing after he computer you must play the same color.
  360.          Highest number wins
  361.      3.  If you don't have that color then you must play whatever color was
  362.          called trumps.  Trump wins
  363.      4.  If you don't have the color or the trump color then you can play
  364.          anything.  You lose this round.
  365.      5.  The "Ultimate" Rook card can be played at any time through out
  366.          the game.  The Rook always wins.
  367.      6.  Whoever wins the round gets to start the next round.  You continue
  368.          until all cards are played.
  369.      7.  Whoever wins the last round gets the cards discarded in the "Junk
  370.          pile" at the beginning of the game.
  371.  
  372. Strategy
  373. --------
  374. Here are a few tips of strategy to help you get started.
  375.  
  376.      1.  If you take the bid, trade with the "Junk pile" so you either have
  377.          high number cards in each color or possibly eliminate a color
  378.          altogether.
  379.      2.  Save the Rook to play on points, not just a plain card.
  380.      3.  Maybe save the Rook to get the last hand so you get the "Junk pile"
  381.          You never know points may be in there...maybe not.
  382.  
  383.  
  384.      Scores are reset the 1st of every month.
  385.  
  386.  
  387.                            Make-Up Days Explanation
  388.                            ------------------------
  389.  
  390.      The make up days feature warrants a little more explanation here.
  391.      When the game is registered, after you have played your game for today,
  392.      it will check to see if make up days has been enabled (start day < 31).
  393.      If today is greater than the start day, and the total number of days you
  394.      have played is not greater than what was specified in the .cfg file, it
  395.      will ask you if you want to play a make up day.  It will then show a
  396.      calendar of days for the current month.  Days that you have played will
  397.      show up in red with an x, playable days will show up in green with an o.
  398.      Choose a valid date (one with an o, within the current month), and you
  399.      will start another days game.  If you changed your mind and do not want
  400.      to play a make up day, enter 99, and you will be asked if you want to
  401.      view the high scores, then be returned to the BBS.
  402.  
  403.                               Special Keys
  404.                               ------------
  405.  
  406.      While WCS Rook 'em is running, the sysop can press certain special keys to
  407.      perform a variety of functions.   The following is a list of the
  408.      functions that the special keys perform:
  409.  
  410.      Key(s)              Function
  411.  
  412.      HOME                Toggles between the user  status window and a help
  413.                          display that lists the special keys.
  414.  
  415.      F6                  Takes 5 minutes away from the caller.
  416.                          NOTE:  This will NOT be returned to BBS.
  417.  
  418.      F7                  Gives 5 minutes to the caller.
  419.                          NOTE:  This will NOT be returned to the BBS.
  420.  
  421.      F9                  Quit the door and return the caller to the BBS.
  422.  
  423.      F10                 Enter  chat mode.  Pressing the  ESC key exits the
  424.                          chat mode.
  425.  
  426.      Alt+D               Drop to DOS.
  427.  
  428.  
  429.                                 Support
  430.                                 -------
  431.  
  432.      If you have problems, I will try and help as best I can, whether you
  433.      are registered or not.  Registered users will get priority over non-
  434.      registered users, though.  You may get help with problems by calling
  435.      Williams Computer Services BBS at (503) 631-8439, or by writing to
  436.      the author at the following addresses:
  437.  
  438.      FIDO     : 1:105/278
  439.  
  440.      Internet : rob@wcs.org
  441.  
  442.      US Mail:
  443.  
  444.           Rob Williams
  445.           18370 S. Henrici Road
  446.           Oregon City, OR 97045
  447.  
  448.  
  449.                          Registering WCS Rook 'em
  450.                          ------------------------
  451.  
  452.      Registration of WCS Rook 'em is only $15.00 for single node
  453.      or $20.00 for Multi-Node.   Please use the form in the file
  454.      REGISTER.FRM.   When  you register,  you will receive a registration
  455.      key that will turn your version into a registered version.
  456.  
  457.      You may also now register and get your keys immediately by calling
  458.      Williams Computer Services BBS at (503) 631-8439 and using the online
  459.      registration door.  Have your Visa or Mastercard ready, fill out the
  460.      proper information, and your keys will be downloaded to you immediately!
  461.  
  462.      Registered users will have access to the special area of the support
  463.      BBS, be able to run multi node (if you purchased a multi node version),
  464.      and have access to make-up days.
  465.  
  466.  
  467.         ***** ALL UPDATES ARE FREE FOR THE LIFE OF THE PROGRAM *****
  468.  
  469.                             Acknowledgements
  470.                             ----------------
  471.  
  472.  Thanks go to the following people/companies (Listed in no particular order):
  473.  
  474.           - Mustang Software for creating Wildcat!
  475.           - Randy Hunt and Mark Goodwin for creating RMDoor which was used
  476.             to create this game.
  477.           - Mike Jordan for his help with some of the routines, and for the
  478.             idea of the make up days, and also help in testing, and his help
  479.             in helping me get started in door programming.  Also, for his help
  480.             with some of the InterBBS ideas.
  481.           - Andy Stewart for his programming help, and also for help in creating
  482.             the main play screen, and for also writing some of the InterBBS
  483.             routines.  These are available with the DDPlus door kit, and are
  484.             FREEWARE!
  485.           - Matt Somerville for writing the help screen and helping with the
  486.             flow/play of the game (as well as rules).  Also, BIG thanks
  487.             for helping test the InterBBS play (a lot of messages went back
  488.             and forth testing it...<Grin>)
  489.           - Gayle Davis and all the people that have contributed to the
  490.             SWAG archives.  I have used various snippets from those
  491.             archives, as well as them giving me good ideas on how to
  492.